home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / developer-tools / guis / gadutil / docs / autodocs / 30.gu_createcontext < prev    next >
Encoding:
Text File  |  1996-07-16  |  1.3 KB  |  40 lines
  1. gadutil.library/GU_CreateContext             gadutil.library/GU_CreateContext
  2.  
  3.    NAME
  4.     GU_CreateContext -- Create a space for GadTools context data.
  5.  
  6.    SYNOPSIS
  7.     gad = GU_CreateContext(glistptr)
  8.     D0                     A0
  9.  
  10.     struct Gadget *GU_CreateContext(struct Gadget **);
  11.  
  12.    FUNCTION
  13.     This function is a replacement for the GadTools version. Use this
  14.     instead. This will make your program to take advantage of future
  15.     enhancements of gadutil.
  16.  
  17.     Creates a place for GadTools to store any context data it might
  18.     need for your window.  In reality, an unselectable invisible
  19.     gadget is created, with room for the context data.
  20.     This function also establishes the linkage from a glist type
  21.     pointer to the individual gadget pointers.  Call this function
  22.     before any of the other gadget creation calls.
  23.  
  24.    INPUTS
  25.  
  26.     glistptr - Address of a pointer to a Gadget, which was previously
  27.                set to NULL.  When all the gadget creation is done, you may
  28.                use that pointer as your NewWindow.FirstGadget, or
  29.                in intuition.library/AddGList(),
  30.                intuition.library/RefreshGList(), FreeGadgets(), etc.
  31.  
  32.    RESULT
  33.     gad - pointer to context gadget, or NULL if failure.
  34.  
  35.    NOTES
  36.     Look in gadtools/CreateContext() for more information.
  37.  
  38.    SEE ALSO
  39.     gadtools/CreateContext()
  40.